package com.coursehub.user.repository;

import com.coursehub.user.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Optional;

/**
 * 用户数据访问层接口
 * 
 * @author CourseHub Team
 */
@Repository
public interface UserRepository extends JpaRepository<User, String> {
    
    /**
     * 根据用户账号查找用户
     * @param userAccount 用户账号
     * @return 用户对象
     */
    Optional<User> findByUserAccount(String userAccount);
    
    /**
     * 根据用户名查找用户
     * @param userName 用户名
     * @return 用户对象
     */
    Optional<User> findByUserName(String userName);
    
    /**
     * 根据用户账号或用户名查找用户
     * @param userAccount 用户账号
     * @param userName 用户名
     * @return 用户对象
     */
    Optional<User> findByUserAccountOrUserName(String userAccount, String userName);
    
    /**
     * 检查用户账号是否存在
     * @param userAccount 用户账号
     * @return 是否存在
     */
    boolean existsByUserAccount(String userAccount);
    
    /**
     * 检查用户名是否存在
     * @param userName 用户名
     * @return 是否存在
     */
    boolean existsByUserName(String userName);
    
    /**
     * 根据角色查找用户列表
     * @param role 角色
     * @return 用户列表
     */
    List<User> findByRole(String role);
    
    /**
     * 根据激活状态查找用户列表
     * @param isActive 激活状态
     * @return 用户列表
     */
    List<User> findByIsActive(Boolean isActive);
    
    /**
     * 根据角色和激活状态查找用户列表
     * @param role 角色
     * @param isActive 激活状态
     * @return 用户列表
     */
    List<User> findByRoleAndIsActive(String role, Boolean isActive);
    
    /**
     * 根据用户名模糊查询
     * @param userName 用户名关键字
     * @return 用户列表
     */
    @Query("SELECT u FROM User u WHERE u.userName LIKE %:userName%")
    List<User> findByUserNameContaining(@Param("userName") String userName);
    
    /**
     * 统计指定角色的用户数量
     * @param role 角色
     * @return 用户数量
     */
    @Query("SELECT COUNT(u) FROM User u WHERE u.role = :role AND u.isActive = true")
    long countActiveUsersByRole(@Param("role") String role);
}